home *** CD-ROM | disk | FTP | other *** search
/ Super Shareware Collection / Super Shareware Collection.iso / sound / wowii23b.zip / WOWIIE.DOC < prev   
Text File  |  1993-07-10  |  42KB  |  1,218 lines

  1.  
  2.  
  3.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  4.  
  5.  
  6.  
  7.                                WOWII Version 2.0ß
  8.                             Module Player for the PC
  9.  
  10.                       "Introduction to the World Of Music"
  11.  
  12.  
  13.      Contents:
  14.  
  15.         I. What the hell IS WOWII?
  16.  
  17.        II. What do I need to use WOWII properly?
  18.  
  19.       III. I want to know what it sounds like!!!
  20.  
  21.        IV. More information for the uninterested... (Or: How It Works)
  22.  
  23.            1.) Commandline Options
  24.  
  25.                a) Short reference of commandline options
  26.  
  27.                b) In-depth description
  28.  
  29.            2.) WOWII.INI - Optionsfile
  30.  
  31.            3.) Keyboard commands
  32.  
  33.         V. Basic Information
  34.  
  35.            1.) "Communication between WOWII and the soundcard" - The Audio DMA
  36.  
  37.            2.) "WOWII dresses extravagant!!" - The 'Tweaked' Video Mode
  38.  
  39.            3.) "Lovelife of Modules" - Portrait of a well-known format
  40.  
  41.        VI. WOWII 2.0ß - "File Finder" - The menu
  42.  
  43.            1.) Basic knowledge about the file selection menu
  44.  
  45.            2.) Keyboard commands
  46.  
  47.            3.) The totally unfinished pulldown menu
  48.  
  49.            4.) Sightseeing tour - Background playing and the DOS shell ...
  50.  
  51.       VII. Copyrights and everything else I threaten with ...
  52.  
  53.            1.) The Shareware Idea
  54.  
  55.            2.) CrippleWare? What is that?
  56.  
  57.            3.) What am I allowed to do exactly?
  58.  
  59.            4.) What could I do more?
  60.  
  61.  
  62.  
  63.  
  64.    Translation: T. Meyer             Page 1                    July 4th, 1992
  65.  
  66.  
  67.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  68.  
  69.  
  70.            5.) "Do I WANT to do more?" - Philosophical Excursions
  71.  
  72.            6.) Copyrights and Restrictions in short!
  73.  
  74.      VIII. How To Register Easily
  75.  
  76.            1. How to get a non-restricted version of WOWII
  77.  
  78.            2. What if I registered already? Upgrade info!
  79.  
  80.        IX. Other things
  81.  
  82.            1.) The All Important Address
  83.  
  84.            2.) Acknowledgments
  85.  
  86.            3.) Some history, sources and other blah
  87.  
  88.         X. Afterword
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                All mentioned Trademarks and Copyrights are
  121.                   registered by their respective owners.
  122.  
  123.              This manual was formatted with PROFF written by
  124.                        Ozan S. Yigit & Steven Tress
  125.  
  126.  
  127.  
  128.    Translation: T. Meyer             Page 2                    July 4th, 1992
  129.  
  130.  
  131.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  132.  
  133.  
  134.    I. What the hell IS WOWII?
  135.    ──────────────────────────
  136.  
  137.           WOWII is  a  program that plays four-voice musicfiles on an
  138.         IBM PC (or compatible).  
  139.  
  140.           WOWII allows  you  to  play  any Soundtracker or ProTracker
  141.         "Module"  on  the PC. These so-called "Modfiles" originate on
  142.         the   Commodore   Amiga  homecomputer  and  serve  mostly  as
  143.         background  or  title  tunes  for games or demos. The modules
  144.         owe  their  popularity  to  their  excellent  sound  that  is
  145.         achieved by four independant digital channels.  
  146.           WOWII supports the following sound cards: 
  147.  
  148.            Creative Technology Ltd.  
  149.  
  150.               - Soundblaster 1.xx-2.xx (mono, 8 bit, max. 22 kHz) 
  151.               - Soundblaster Pro 3.xx (stereo, 8 bit, max. 22 kHz) 
  152.               - Soundblaster 16 ASP (stereo, 8 bit, max. 44 kHz) 
  153.  
  154.            Mediavision 
  155.  
  156.               - Pro Audio Spectrum Plus (stereo, 8 bit, max. 44 kHz) 
  157.               - Pro Audio Spectrum 16 (stereo, 8 bit, max. 44 kHz) 
  158.  
  159.            AdLib Inc.  
  160.  
  161.               - AdLib Gold 1000 (stereo, 8 bit, max. 44kHz) 
  162.  
  163.  
  164.    II. What do I need to use WOWII properly?
  165.    ─────────────────────────────────────────
  166.  
  167.           One of   the   sound   cards  listed  above  is  absolutely
  168.         necessary  in order for WOWII to work. Compatible sound cards
  169.         will  be supported, too, of course, given they are compatible
  170.         with  one  of the cards listed above. Examples for compatible
  171.         cards   are  the  Sound  Galaxy  series  or  Thunderboard  by
  172.         Mediavision.  
  173.  
  174.           Because the  output  of four digitized voices requires lots
  175.         of  processing  power,  the  minimal configuration is a 80286
  176.         AT.  You  will  be  able  to customize WOWII to the computing
  177.         capacities   of   your  specific  computer.  Additionally,  a
  178.         Standard-VGA graphics adapter is necessary.  
  179.  
  180.           And last,  but  not  least,  you  will  need  some modules.
  181.         Soundtracker  and  ProTracker  modules  are available on many
  182.         BBSes  and  at  Public  Domain  dealers.  "Modfiles" are very
  183.         popular,  so  it  should  be  no  problem for you to put your
  184.         hands on a few.  
  185.  
  186.           If you  still  have  problems getting them, you can contact
  187.         me.  For  a  few bucks I will browse through my collection of
  188.         around 600 modules and copy a few of them for you.  
  189.  
  190.  
  191.  
  192.    Translation: T. Meyer             Page 3                    July 4th, 1992
  193.  
  194.  
  195.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  196.  
  197.  
  198.  
  199.    III. I want to know what it sounds like!!!
  200.    ──────────────────────────────────────────
  201.  
  202.           If all  requirements mentioned under II. are fulfilled, you
  203.         are  absolutely  ready  to  enjoy  the  pleasure of digitally
  204.         reproduced music.  
  205.  
  206.           The following recommendations should be followed: 
  207.           - The  files  WOWII.EXE  and  WOWII.PIC must be in the same
  208.             directory.  
  209.           - The  sound  card  has to be installed properly. Owners of
  210.             Soundblaster  Pro  and  16  ASP cards may have to include
  211.             the   DMA  channel  for  8  bit  sound  with  the  /DMA:x
  212.             argument.  
  213.  
  214.                                   *WARNING*
  215.  
  216.             If  you  forget  to  include  this parameter and your
  217.             Soundblaster  is  configured to any other DMA channel
  218.             than  DMA  1, you will only be able to enjoy complete
  219.             silence.  
  220.  
  221.           Example: You  want  to  play  the  module "AXEL-F.MOD". You
  222.         should run WOWII from the DOS commandline as follows: 
  223.  
  224.                 WOWII axel-f 
  225.  
  226.           The ".MOD" extension will be automatically appended.  
  227.  
  228.           When you  press  the  [Return]-key  the  screen  blanks and
  229.         after   a  brief  moment  you  will  see  a  display  with  4
  230.         oscilloscopes  and 4 peakmeters. If you do not see this, your
  231.         system  has  no VGA compatible graphics card installed or you
  232.         gave a wrong filename.  
  233.  
  234.           To leave   the   program,   you  will  have  to  press  the
  235.         [Esc]-key.  A  few informational texts appear and you will be
  236.         returned to the DOS commandprompt.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.    Translation: T. Meyer             Page 4                    July 4th, 1992
  257.  
  258.  
  259.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  260.  
  261.  
  262.    IV. More information for the uninterested... (Or: How It Works)
  263.    ───────────────────────────────────────────────────────────────
  264.  
  265.      1.) Commandline Options
  266.      ───────────────────────
  267.  
  268.           WOWII has  lots  of  commandline options and will interpret
  269.         them   correctly  (most  of  the  time).  The  order  is  not
  270.         important,  WOWII  tries  very  hard  to  figure out what you
  271.         mean.  
  272.  
  273.           A quick  reference  of  all  options  WOWII  understands is
  274.         printed when you call WOWII *without* any option.  
  275.  
  276.           Example: 
  277.  
  278.         C:\MODFILES>WOWII [RETURN]
  279.         WOWII Version 2.0ß Multiple Output Device MODPlayer Copyright 1993 JOS
  280.         Usage: WOWII MODFile[.MOD] [/H:xxxxx] [/S] [/L] [/V:xxx] [/T:xxx] [...]
  281.                /H:xxxxx sets the output frequency.
  282.                /S starts WOWII with an (un)Realtime Spectrum Analyzer.
  283.                /L loops the module.
  284.                /V:xxx, /T:xxx, /B:xxx presets volume, treble and bass (0-100).
  285.                /E for enhanced stereo (AdLib Gold or Pro Audio Spectrum).
  286.                /O for setting the loudness switch (Pro Audio Spectrum only).
  287.                /DMA:x specifies the DMA channel for the Soundblaster.
  288.                /M:xxxxx defines the size of the DMA transfer buffer (2048-12288).
  289.                /NOXMS disables the usage of the Upper Memory Blocks (UMBs).
  290.                /MAX computes the maximum amount of memory available for a MODULE.
  291.                /ADJ adjusts the frequency.
  292.  
  293.         C:\MODFILES>
  294.  
  295.           This reference  can  be displayed anytime this way, to ease
  296.         the usage of WOWII.  
  297.  
  298.  
  299.      a.) Short reference of commandline options
  300.      ──────────────────────────────────────────
  301.  
  302.           /H:xxxxx specifies  the  output  frequency. You should only
  303.         use values from 8000 to 44000Hz.  
  304.  
  305.           /S displays  a  "(un)RealTime  Spectrum  Analyzer"  in  the
  306.         lower part of the display instead of the 4 oscilloscopes.  
  307.  
  308.           /L will  restart the module from the beginning when the end
  309.         is reached.  
  310.  
  311.           /V:xxx, /T:xxx,  /B:xxx will set the volume, bass or treble
  312.         level  to  0-100  percent,  respectively. Bass and treble can
  313.         only   be   set  on  specific  sound  cards.  These  are  the
  314.         Soundblaster  16  ASP, AdLib Gold and Pro Audio Spectrum Plus
  315.         or 16.  
  316.  
  317.  
  318.  
  319.  
  320.    Translation: T. Meyer             Page 5                    July 4th, 1992
  321.  
  322.  
  323.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  324.  
  325.  
  326.           /E enables  the Enhanced Stereo option of the AdLib Gold or
  327.         Pro  Audio  Spectrum  sound  cards.  A  3D-like sound will be
  328.         created by using sophisticated algorithms.  
  329.  
  330.           /O enables  the  Loudness  option of the Pro Audio Spectrum
  331.         card.  
  332.  
  333.           /DMS:x specifies   the  DMA  channel  of  the  Soundblaster
  334.         cards. Default is DMA channel 1.  
  335.  
  336.           /M:xxxxx specifies  the  size of the DMA buffer. Default is
  337.         4096.  
  338.  
  339.           /NOXMS disables  usage of the "Upper Memory Blocks" between
  340.         640K  and  1MB,  which  are  provided by the XMS interface of
  341.         some memory managers.  
  342.  
  343.           /MAX calculates  the  maximum  memory  size available for a
  344.         modfile.   The demo version of WOWII also displays the memory
  345.         which is available in the registered version.  
  346.  
  347.           /ADJ tells  WOWII  to  adjust  the  output frequency to the
  348.         sound  card.   Most  sound  cards  do  not provide infinitely
  349.         variable output frequencies.  
  350.  
  351.  
  352.      b.) In-depth description
  353.      ────────────────────────
  354.  
  355.           The option  /H:xxxxx  specifies  the  output  frequency  in
  356.         Hertz.  The  higher  the  frequency,  the  more  data must be
  357.         output and of course calculated per second.  
  358.           A frequency  of  44KHz requires a lot more processing power
  359.         than  a  frequency of 16KHz. The default frequency is 22000Hz
  360.         and  should  fit  normal  quality  demands.  When  using  the
  361.         highest  frequency  of  44KHz,  even  fast computers like IBM
  362.         386DX  with  40MHz  are  at  the  peak  of  their capacities.
  363.         Specifying  an  output  frequency  too high for your computer
  364.         results in off tune sounds during play.  
  365.           If you  experience  any of these problems, you will have to
  366.         decrease  the  output  frequency  or  use  the  "(un)Realtime
  367.         Spectrum Analyzer" instead of the 4 oscilloscopes.  
  368.  
  369.           The option  /M:xxxxx  specifies the size of the DMA-buffer.
  370.         WOWII  uses  a variable sized memory area for the transfer of
  371.         the  audio  data.  Parts of the digital music are stored here
  372.         and are being played by the soundcard itself.  
  373.           The bigger  the buffer, the longer the delay after pressing
  374.         special  keys,  e.g.  Fast  Forward,  Rewind,  or  muting the
  375.         channels. Default size is 4096 bytes.  
  376.  
  377.           The option  /S  forces  WOWII  to display the "(un)Realtime
  378.         Spectrum  Analyter" right from the start of the program. This
  379.         display  uses  less processing time than the 4 oscilloscopes,
  380.         so   you  can  squeeze  some  more  Hertz  out  of  a  slower
  381.  
  382.  
  383.  
  384.    Translation: T. Meyer             Page 6                    July 4th, 1992
  385.  
  386.  
  387.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  388.  
  389.  
  390.         computer.  
  391.  
  392.           The /DMA:x   option   is   only   important  to  owners  of
  393.         Soundblaster  Pro or 16 ASP cards. These cards do not provide
  394.         a  mechanism for a program to find out which DMA channel they
  395.         are  configured  to. If your Soundblaster Pro or 16 ASP (in 8
  396.         bit  mode) is configured to any other DMA channel than DMA 1,
  397.         you have to use the /DMA:x option! 
  398.  
  399.           The /NOXMS  option  should  only  be  used if WOWII crashes
  400.         without reason.  
  401.  
  402.  
  403.  
  404.      2.) WOWII.INI
  405.      ─────────────
  406.  
  407.           The WOWII.INI  file  can  be used to store default options.
  408.         All  options  mentioned  under  IV.1.  may  be used, but only
  409.         *one*  option  on  a line.  WOWII.INI must reside in the same
  410.         directory as WOWII.EXE and WOWII.PIC! 
  411.  
  412.           Example for WOWII.INI: 
  413.  
  414.       ────────────────────────────────────────────────── cut here
  415.       ; WOWII.INI  Copyright (c) 1993  Jan Ole Suhr
  416.       ; Commands:
  417.       ; modfile[.mod] Name of module.
  418.       ; /H:xxxxx      Output frequency in Hertz (14000-23000).
  419.       ; /S            Start-up WOWII with the "(un)Realtime Spectrum Analyzer".
  420.       ; /L            Repeat module forever.
  421.       ; /V:xxx, /T:xxx, /B:xxx Specifies volume, bass or treble, respectively.
  422.       ; /E            Enables Enhanced Stereo (AdLib Gold and PAS).
  423.       ; /O            Enables Loudness (Pro Audio Spectrum).
  424.       ; /DMA:x        Specify DMA channel of Soundblaster cards.
  425.       ; /M:xxxxx      Specifies the size of the DMA-buffer (2048-12288).
  426.       ; /NOXMS        Disables usage of Upper Memory Blocks.
  427.       ; /MAX          Print maximum of available memory for module.
  428.       ; /ADJ          Adjust output frequency to sound card.
  429.       /H:22050
  430.       /L
  431.       /V:100
  432.       /B:90
  433.       /ADJ
  434.       ────────────────────────────────────────────────── cut here again
  435.  
  436.           Please note  that  lines  beginning  with a semicolon (";")
  437.         are  interpreted  as  remarks.  The  example  above  sets the
  438.         output  frequency  to  22050  Hz,  enables  looping, sets the
  439.         volume  to  100  percent,  bass  to  90  percent  and enables
  440.         adjustment of the output frequency to the sound card.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.    Translation: T. Meyer             Page 7                    July 4th, 1992
  449.  
  450.  
  451.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  452.  
  453.  
  454.      3.) Keyboardcommands
  455.      ────────────────────
  456.  
  457.           WOWII allows  the  user  to  manipulate the reproduction of
  458.         the  music  in  many ways. You can activate many options that
  459.         influence the music directly or indirectly.  
  460.           The keyboard  routine  was  implemented  in a way that even
  461.         simultaneous  keypresses  are  recognized  correctly  and are
  462.         even handled simultaneously most of the time.  
  463.  
  464.       WOWII 2.0ß       - Keystrokes -                             28.06.1993
  465.     ─────────────────┬─────────────────────────────────────────────────────────
  466.       Key:           │ Description:
  467.                      │
  468.       [Esc]          │ quits WOWII. If you tagged a bunch of modfiles from the
  469.                      │ menu then [Esc] jumps to the next modfile in the row.
  470.                      │
  471.       [Ctrl]         │ quits WOWII even if there are some tagged modfiles up
  472.                      │ to be played.
  473.                      │
  474.       1, 2, 3, 4     │ enables and disables muting of channel 1-4.
  475.                      │
  476.       R              │ forces the time display from forward to reverse counting
  477.                      │ and vice versa.
  478.                      │
  479.       [Home]         │ jumps to the beginning of a modfile.
  480.                      │
  481.       Cursor right/  │ fast forward or rewind.
  482.       Cursor left    │
  483.                      │
  484.       Page up/down   │ jumps to the next/previous pattern.
  485.                      │
  486.       Shift-[F1]..   │ stores the current position of the modfile in one of 10
  487.       Shift-[F10]    │ memories.
  488.                      │
  489.       [F1]..[F10]    │ restores the saved position.
  490.                      │
  491.       Cursor up/     │ switches to the instrument page and back.
  492.       Cursor down    │
  493.                      │
  494.       +, - on the    │ increases or decreases the output volume.
  495.       Numeric Pad    │
  496.                      │
  497.       V, B, T        │ assigns the cursor right and left keys to the mixer 
  498.                      │ functions "set volume", "set bass" and "set treble".
  499.                      │ The functions "set bass" and "set treble" are only 
  500.                      │ available on the following soundcards:
  501.                      │ Soundblaster 16 ASP, AdLib Gold, Pro Audio Spectrum
  502.                      │
  503.       5,6,7,8,9,0    │ Sets the volume, bass or treble to 30%-100%.
  504.                      │
  505.       [Space]        │ re-assigns the cursor right and left keys to the function
  506.                      │ of fast forward and rewind.
  507.  
  508.  
  509.  
  510.  
  511.  
  512.    Translation: T. Meyer             Page 8                    July 4th, 1992
  513.  
  514.  
  515.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  516.  
  517.  
  518.                      │
  519.       E              │ switches from "Enhanced Stereo" (Pro Audio Spectrum) or
  520.                      │ "Spatial Stereo" (AdLib Gold) to normal replay and vice
  521.                      │ versa.
  522.                      │
  523.       L              │ turns Loudness on/off (Pro Audio Spectrum).
  524.     ─────────────────┴─────────────────────────────────────────────────────────
  525.  
  526.  
  527.  
  528.    V. Basic Information
  529.    ────────────────────
  530.  
  531.      "1.) "Communication between WOWII and SB" - DMA and other stuff
  532.      ───────────────────────────────────────────────────────────────
  533.  
  534.           In difference  to  other Module-Players like MP (ModPlay by
  535.         Mark  J.  Cox), WOW (oohh, from meeee) or SPP (Super Pro Play
  536.         by  Joshua  C.   Jensen),  WOWII uses the DMA-Transfer of the
  537.         soundcards for digital output.  
  538.           Most sound  cards  can  only be used to their fullest (e.g.
  539.         stereo, 44 kHz) by using the DMA.  
  540.  
  541.           Additionally, DMA  (Direct  Memory  Access)  has some other
  542.         important  advantages: By using DMA, the processor is free to
  543.         do  other  things,  while  the  soundcard outputs the data by
  544.         itself.  Data-transfer from memory to the soundcard is almost
  545.         transparent.  This  way,  the  processor  can  calculate  the
  546.         digital  data,  while the sound card reads the pre-calculated
  547.         data from memory and writes it to the analog output.  
  548.  
  549.           The new  WOWII 2.0ß does not use the double buffering method
  550.         anymore.   Instead, the DMA controller is told to provide the
  551.         same memory area to the sound card all the time.  
  552.  
  553.           Due to   this   method,   some   difficulties   during  the
  554.         development of WOWII were encountered: 
  555.           If some  graphical output corresponding to the audio output
  556.         is  desired,  the  visual representation of the music must be
  557.         synchronized  to  the  previously  calculated audio data. For
  558.         this  purpose  WOWII uses a timer provided by your computer's
  559.         hardware.  After  a  certain  amount  of time has passed, the
  560.         graphics are updated.  
  561.  
  562.           Important! In  version  2.0ß,  WOWII  is not able to use any
  563.         other  DMA  channel than 0, 1, 2 or 3. This is only a problem
  564.         for  owners of Pro Audio Spectrum cards, who configured their
  565.         card  to  use  DMA  channel  4,  5,  6  or 7. As long as this
  566.         problem  is  not  solved,  I  advise you to re-configure your
  567.         sound card.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.    Translation: T. Meyer             Page 9                    July 4th, 1992
  577.  
  578.  
  579.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  580.  
  581.  
  582.      2.) "WOWII dresses extravagant!!" - The 'Tweaked' Video Mode
  583.      ────────────────────────────────────────────────────────────
  584.  
  585.           WOWII uses  an  undocumented  videomode of the standard VGA
  586.         graphics   card  for  it's  display.  This  mode  supports  a
  587.         resolution   of   320x240   pixels   in  256  colors  with  a
  588.         pixelresolution  of  1:1  and  is  an  improvement  over  the
  589.         standard   256   color  mode  with  320x200  pixels.  Another
  590.         advantage is the availability of more than one screen page.  
  591.           Although this  videomode  is undocumented, all standard VGA
  592.         graphics cards should support it.  
  593.  
  594.           Multitaskingsystems like  Windows, DesqView (/X) or OS/2 do
  595.         not  store  the  attributes  of  the videomode correctly when
  596.         switching  to  another application. This is not WOWII's fault
  597.         of  using  an  "undocumented" videomode, but the programmers'
  598.         of  these  systems  who  seem  to be uncapable of storing the
  599.         visual environment of the tasks correctly.  
  600.  
  601.           WOWII has  been released over a year ago and still there is
  602.         no  update  for  Windows,  OS/2  or DesqView, which fixes the
  603.         problem,  so  I  have  to  get to the conclusion that the big
  604.         software companies are ignoring me! 
  605.  
  606.  
  607.      3.) "Lovelife of Modules" - Portrait of a well-known format
  608.      ───────────────────────────────────────────────────────────
  609.  
  610.        Sadly this STILL has not been a very investigated topic yet...
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.    Translation: T. Meyer            Page 10                    July 4th, 1992
  641.  
  642.  
  643.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  644.  
  645.  
  646.    VI. WOWII 2.0ß - "File Finder" - The menu
  647.    ─────────────────────────────────────────
  648.  
  649.      1.) Basic knowledge about the file selection menu
  650.      ─────────────────────────────────────────────────
  651.  
  652.           The file  selector  consists  of two programs: MENU.EXE and
  653.         INTERNAL.EXE.   MENU.EXE is the file selector program itself,
  654.         which  will  run  INTERNAL.EXE  and  WOWII.EXE.  INTERNAL.EXE
  655.         cannot be run directly from DOS.  
  656.  
  657.           After running  the  file  selector, you will see a pulldown
  658.         menu  at  the  top,  and a status line at the bottom, and the
  659.         file selection area in the middle of your screen.  
  660.  
  661.           In this  area,  all  modfiles,  directories  and drives are
  662.         listed  in  different  colors. Modfiles are listed in yellow,
  663.         directories in magenta and drives in light cyan.  
  664.  
  665.           To select  an  entry  in the file selector, use your cursor
  666.         keys,   which  will  move  the  blue  selection  bar  in  the
  667.         direction  of  the  key  press.   Press  Return  to  play the
  668.         modfile  the  selection bar is on via WOWII.  If you select a
  669.         directory  or  drive  by  pressing  Return, the file selector
  670.         will read that directory or switch to the selected drive.  
  671.  
  672.           You can  use  the space bar to select a few modfiles, which
  673.         will  be  played  using  WOWII  when  you  press  Return. The
  674.         modules  are  played  in  the  order  of selection: the first
  675.         selected  file  at  the  beginning,  the last selected at the
  676.         end.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.    Translation: T. Meyer            Page 11                    July 4th, 1992
  705.  
  706.  
  707.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  708.  
  709.  
  710.      2.) Keyboard commands
  711.      ─────────────────────
  712.  
  713.       MENU.EXE  "File Finder"  - Keystrokes -                    28.06.1993
  714.     ─────────────────┬─────────────────────────────────────────────────────────
  715.       Key:           │ Description:
  716.                      │
  717.       [Alt]-X/-Q     │ exits the menu and returns to DOS.
  718.                      │
  719.       Cursor right/  │ moves the highlighted bar, left, up or down.
  720.       left/up/down   │ 
  721.                      │
  722.       [Space]        │ tags or untags a modfile.
  723.                      │
  724.       [Home]         │ jumps to the first entry in the list of modfiles.
  725.                      │
  726.       [End]          │ jumps to the last entry in the list.
  727.                      │
  728.       [Enter],       │ - if there are any tagged modfiles, then they will be
  729.       [Return]       │   played by WOWII.
  730.                      │ - if the the highlighted bar points to a directory or a
  731.                      │   disk drive then the directory will be opened or the
  732.                      │   disk drive will be changed.
  733.                      │ - if the highlighted bar points to a modfile then this
  734.                      │   file will be played by WOWII.
  735.                      │
  736.       R              │ re-reads the list of modfiles.
  737.                      │
  738.       F              │ turns the reading of the information of the modfiles
  739.                      │ (titel, instruments and patterns) on or off.
  740.                      │
  741.       I              │ reads the information of a single modfile.
  742.                      │
  743.       B              │ background replaying of a modfile.
  744.                      │
  745.       D              │ jumps to a DOS-shell.
  746.                      │
  747.       [F10]          │ activating the pulldown-menu.
  748.     ─────────────────┴─────────────────────────────────────────────────────────
  749.  
  750.  
  751.       3.) The totally unfinished pulldown menu
  752.       ────────────────────────────────────────
  753.  
  754.            To enter  the  pulldown menu, press the [F10] key. Use the
  755.          cursor keys to navigate through the pulldown menu.  
  756.  
  757.            At the  moment, you are only able to select the menu items
  758.          "Configuration  of  WOWII  2.0ß"  and  "Print List". A dialog
  759.          window  will  appear in either case, in which you can adjust
  760.          a few parameters.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.    Translation: T. Meyer            Page 12                    July 4th, 1992
  769.  
  770.  
  771.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  772.  
  773.  
  774.       4.) Sightseeing tour - Background playing and the DOS shell ...
  775.       ───────────────────────────────────────────────────────────────
  776.  
  777.            Press 'B'  to  play a modfile in the background. This will
  778.          only  be  possible,  when  enough  memory  is available. The
  779.          status  line  will  display  the  current  position  in  the
  780.          modfile during play.  
  781.  
  782.            Press 'D'  to  enter  a  DOS  shell. Sadly, the shell will
  783.          only  have  limited  memory available. You can enter the DOS
  784.          shell when playing a module, of course.  
  785.  
  786.  
  787.  
  788.          [ And Now For Something Completely Different ]
  789.  
  790.     VII. Copyrights and everything else I threaten with ...
  791.     ───────────────────────────────────────────────────────
  792.  
  793.       1.) The Shareware Idea
  794.       ──────────────────────
  795.  
  796.            Shareware are  programs  that  were  put together by hobby
  797.          programmers  and  that  are  not  distributed via commercial
  798.          channels  (e.g.  a  Software  Publisher).  Due to this, most
  799.          authors  release versions of their programs that are more or
  800.          less  usable  and  may be freely distributed. These versions
  801.          are  spreading  very  fast  most  of  the  time and make the
  802.          program known to a lot of users.  
  803.            By 'registering'  the  program,  the user will get a fully
  804.          functional  version of the program. To do this, the user has
  805.          to send the author some money.  
  806.  
  807.            If a  programmer receives lots of registrations he will be
  808.          convinced  to  put  a  lot  more effort into the program, in
  809.          order to satisfy the users who registered.  
  810.            Should the  programmer  receive  very few registrations he
  811.          will  most likely get deep depressions which can result in a
  812.          very   strange   behaviour.  Some  authors  have  even  gone
  813.          commercial.  
  814.  
  815.  
  816.       2.) CrippleWare? What is that??
  817.       ───────────────────────────────
  818.  
  819.            Shareware programs  lacking  so  many  features  that they
  820.          become useless to the user are called CrippleWare.  
  821.            The crippling  of  his  software  is the programmer's only
  822.          way  of guaranteering it's protection from being copied like
  823.          hell  with  him  not  getting any rewards. The distance from
  824.          bearable  to  unbearable  restrictions  is  very narrow. But
  825.          think  of  the programmer who is getting word of his program
  826.          being   used   far   more   often   than   he  has  received
  827.          registrations...  
  828.  
  829.  
  830.  
  831.  
  832.    Translation: T. Meyer            Page 13                    July 4th, 1992
  833.  
  834.  
  835.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  836.  
  837.  
  838.  
  839.       3.) What am I allowed to do exactly?
  840.       ────────────────────────────────────
  841.  
  842.            WOWII is  a  Shareware  program. This yields the following
  843.          rules: 
  844.  
  845.            You are  allowed  to  test  WOWII for a period of 4 (four)
  846.          weeks  after  receipt,  to  see if it fits your needs. After
  847.          this  period  you  are  not  allowed  to use the program any
  848.          further.  
  849.  
  850.            Whoever gets  himself  another testversion of WOWII to get
  851.          himself  another four weeks of testing incurs penalty ( ever
  852.          seen a PC disintegrating to star dust? ).  
  853.  
  854.            WOWII may  be freely distributed, even after expiration of
  855.          the testing period.  
  856.  
  857.            Even Shareware-Distributors    or    dealers,    who   are
  858.          distributing  Shareware  by  mail,  may  put  WOWII in their
  859.          collection.   The  same  is  valid  for  other  distribution
  860.          channels,  e.g.  'Bildschirmtext'  or 'Channel Videodat' and
  861.          other  electronic  online  services.  I  insist  on  getting
  862.          notified   if   WOWII   is  distributed  on  such  channels.
  863.          Additionally,  the  costs  for  getting  the demo version of
  864.          WOWII may not exceed 10 DM (7 US-Dollars).  
  865.  
  866.            WOWII may  not be used commercially in the testing period.
  867.          This  includes  single sale and bundling with other soft- or
  868.          hardware.   Exceptions  may  be granted after contacting me.
  869.          If I agree, I will send you a written permission.  
  870.  
  871.            WOWII must  not  be  used  for  any  purpose of commercial
  872.          advertising.  You  are not allowed to run the demoversion of
  873.          WOWII  on  your  computer  on an exhibition or in a computer
  874.          store   for   any  purpose  of  advertising  your  hardware.
  875.          Exceptions may be granted after contacting me.  
  876.  
  877.            WOWII may  not  be  modified  and  this  is  valid for the
  878.          distribution  archive, too. This includes adding advertising
  879.          textfiles for BBS or something like that to the archive.  
  880.  
  881.            Disassembling WOWII  does  *not*  incur  penalty. But when
  882.          using my routines, please state the original author.  
  883.  
  884.          I  would  be  very  grateful,  if  all  hackers and crackers
  885.          refrain  from  WOWII.  It  is not very honourable to crack a
  886.          USD  ShareWare product, is it? 
  887.  
  888.  
  889.       4.) What could I do more?
  890.       ─────────────────────────
  891.  
  892.            If you   register   WOWII,   you   will  receive  a  fully
  893.  
  894.  
  895.  
  896.    Translation: T. Meyer            Page 14                    July 4th, 1992
  897.  
  898.  
  899.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  900.  
  901.  
  902.          functional    and   unrestricted   version.   I   offer   an
  903.          "updateservice"  free  of  charge, which guarantees free new
  904.          versions  to the original registrator. It is for the user to
  905.          get himself the new version, either by mail or modem.  
  906.  
  907.            I am  planning  to implement many new features into WOWII.
  908.          The  most  important  is  an  interactive  interface,  which
  909.          allows  easy  selection  of modules instead of one at a time
  910.          by commandline.  
  911.  
  912.            The development  of  these  features depends on the number
  913.          of  registrations  I will receive. Also, I'm very interested
  914.          in ideas you may have.  
  915.  
  916.  
  917.       5.) "Do I WANT to do more?" - Philosophical Excursions"
  918.       ───────────────────────────────────────────────────────
  919.  
  920.            "I would  like to express my deepest admiration to anyone,
  921.          who  can live without WOWII after testing it for four weeks.
  922.          This  leads  me  to the conclusion that there are still some
  923.          persons  out there who can pull themselves together and keep
  924.          their  most inner feelings and natural desires for play, fun
  925.          and  suspense  (version  2.0  in  the  handy chocolate egg -
  926.          doesn't  melt  in the hand, but on the modem's power supply)
  927.          under total control." 
  928.               - Jan Ole Suhr, 1992 
  929.  
  930.            Not everyone    is   into   registering   Shareware,   but
  931.          nonetheless  I  would  like  to explain what my reception of
  932.          the Shareware idea is.  
  933.  
  934.            There are  loads  and  loads of Shareware authors, who are
  935.          scattered  all  over  the  world.  They deliver high-quality
  936.          software  to  a  wide  range  of  users  and  many  of their
  937.          products  reach  the quality standard of commercial products
  938.          and  some  are  even better. Most of these programming ideas
  939.          could  not  be realized by the 'big' software companies, but
  940.          a  corresponding  market  for the Shareware is non-existant.
  941.          The  Biggies  are  busy  enough  handling  their  own  brand
  942.          products  and  are  scared of investing into other projects.
  943.          On  the other hand, the small software companies do not have
  944.          the   appropriate   distribution   channels   and   so  they
  945.          specialise  on  individual solutions, that are paid for very
  946.          good.  
  947.  
  948.            When a  Shareware  author  takes the role of a 'lifeguard'
  949.          of  innovation and does not get support from the *users*, it
  950.          is very frustrating.  
  951.  
  952.            It is  getting  especially  annoying when one has to argue
  953.          about  absolutely  rediculously  low fees, whose value often
  954.          only cover the author's expenses.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.    Translation: T. Meyer            Page 15                    July 4th, 1992
  961.  
  962.  
  963.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  964.  
  965.  
  966.       6.) Copyrights and Restrictions in short!
  967.       ─────────────────────────────────────────
  968.  
  969.            The program  WOWII  Version  1.xx  and 2.xx is copyrighted
  970.          and  was  evidently  developed  by  Jan  Ole  Suhr. Who ever
  971.          spoils  his  soup  by taking my code without credit will get
  972.          his  stomach  emptied  by me, ok? All rights regarding WOWII
  973.          are reserved by me.  
  974.  
  975.          All restrictions in the WOWII demo version in a nut shell: 
  976.  
  977.            - limited testing period of 4 weeks 
  978.  
  979.            - a  colorful  logo  laid  over  the oscilloscopes and the
  980.              sample list 
  981.  
  982.            - no "Spectrum Analyzer", not even a little peak 
  983.  
  984.            - 2 nice ending screens 
  985.  
  986.            - only  a  maximum  of  50  modfiles  in the file selector
  987.              (2000 in the registered version!) 
  988.  
  989.  
  990.  
  991.     VIII. How To Register Easily
  992.     ────────────────────────────
  993.  
  994.  
  995.        1.) How to get a non-restricted version of WOWII
  996.        ────────────────────────────────────────────────
  997.  
  998.            Those who  want  to  get  WOWII  without  a  timelimit and
  999.          nerving texts, should contact the nice and needy author.  
  1000.  
  1001.            Please complete  the  ORDER.DOC form and mail it, together
  1002.          with  a  stamped  and  self-addressed  envelope,  a  disk of
  1003.          current  format  and  20  US Dollars (or the equal amount in
  1004.          your  currency)  in notes or a collection-only check, to the
  1005.          author: 
  1006.  
  1007.                  Jan Ole Suhr
  1008.                  Bockhorster Weg 28
  1009.                  28876 Oyten
  1010.                  Germany
  1011.  
  1012.  
  1013.        2.) What if I registered already? Upgrade info!
  1014.        ───────────────────────────────────────────────
  1015.  
  1016.            I decided,   against   the  original  statement  that  all
  1017.          updates  are  for  free, to set up a special arrangement for
  1018.          the upgrade from WOWII 1.xx to WOWII 2.0ß: 
  1019.  
  1020.            Everyone, who  has  a  registration  number (the last four
  1021.  
  1022.  
  1023.  
  1024.    Translation: T. Meyer            Page 16                    July 4th, 1992
  1025.  
  1026.  
  1027.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  1028.  
  1029.  
  1030.          digits)  of greater or equal 400, will receive a free update
  1031.          from  WOWII  1.xx  to  WOWII 2.0ß. Anyone with a registration
  1032.          number  less  than  400 is urged to send me a letter with 10
  1033.          DM  (6 US-Dollars), stating that he wants an update of WOWII
  1034.          (no  SASE  or  diskette!).  I will provide the costs for the
  1035.          disk, packaging and shipping myself.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.       Short addendum:
  1042.       ───────────────
  1043.            Of course  I am very pleased when I receive disks with new
  1044.          modfiles.   But  please, if you do, just send *one* disk. If
  1045.          the  resonance  is  as  huge as it was with WOW, I will have
  1046.          all  my  hands  full  handling  the registrations and cannot
  1047.          fill all those disks with modules again.  
  1048.            Also, I  am  very  interested  in  any  new innovations in
  1049.          music  reproduction.  Those  who  program  stuff  like  this
  1050.          themselves are encouraged to send it to me, too.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.    Translation: T. Meyer            Page 17                    July 4th, 1992
  1089.  
  1090.  
  1091.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  1092.  
  1093.  
  1094.     IX. Other things
  1095.     ────────────────
  1096.  
  1097.       1.) The All Important Address
  1098.       ─────────────────────────────
  1099.  
  1100.            The author's address:
  1101.  
  1102.                  Jan Ole Suhr
  1103.                  Bockhorster Weg 28
  1104.                  28876 Oyten
  1105.                  Germany
  1106.  
  1107.            Tel.: 04207/801033
  1108.  
  1109.            Fido: Jan Ole Suhr, 2:241/2302.8
  1110.  
  1111.  
  1112.       2.) Acknowledgments
  1113.       ───────────────────
  1114.  
  1115.            At first,  let  me  thank  my  betatesters Michael Baekow,
  1116.          MnemoTroN  (Thomas  Meyer), Mogwai (Roger Böhmermann), Harald
  1117.          Zappe, Daniel Hesse, Daniel Meer and Markus Schwarz.  
  1118.  
  1119.            I am  especially  indebted  to  Michael Baekow for testing
  1120.          WOWII   in   a  very  hard  and  intensive  way  (OS/2  2.0,
  1121.          Soundblaster Pro).  
  1122.  
  1123.            WOWII's almost  perfect  emulation  of most of the effects
  1124.          from   the   original   Amiga   ProTracker  is  due  to  the
  1125.          information  provided  by  MnemoTroN (Thomas Meyer). He also
  1126.          gave  me  the  opportunity  of  listening  to  WOWII  on the
  1127.          Soundblaster Pro, thus awakening tremendous euphoria.  
  1128.  
  1129.            "The World Is Waiting" (tm) - MnemoTroN, 1992.
  1130.  
  1131.            Another "Thank  you" to Boris Ottlewski, who lent me a Pro
  1132.          Audio  Spectrum 16 and is now working on the new WOWIII with
  1133.          me.  
  1134.  
  1135.            Two other  persons  I  would like to thank very deeply are
  1136.          Harald  Zappe, who spared no expenses in order to provide me
  1137.          with   information   regarding   the   programming   of  the
  1138.          Soundblaster  Pro  and  Jim  Chun  Wah, Software Engineer at
  1139.          Creative  Labs,  Singapore,  who  helped  me with a few very
  1140.          difficult problems.  
  1141.  
  1142.            I must  not forget my friend Sven Rohde, who often bursted
  1143.          my   illusions   with   almost  unsolvable  suggestions  and
  1144.          improvement  ideas.  His  criticism is appalling, but that's
  1145.          how it goes with "non-computing" friends.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.    Translation: T. Meyer            Page 18                    July 4th, 1992
  1153.  
  1154.  
  1155.    WOWII V2.0ß                                Copyright (c) 1993 Jan Ole Suhr
  1156.  
  1157.  
  1158.       3.) Some history, sources and other noteworthy stuff
  1159.       ────────────────────────────────────────────────────
  1160.  
  1161.                              to be continued ...
  1162.  
  1163.  
  1164.  
  1165.     X. Afterword
  1166.     ────────────
  1167.  
  1168.            I would  like to wish you much fun while testing WOWII and
  1169.          may no bugs be with you! 
  1170.  
  1171.          "I'm a man on a mission! - WOWII 2.0ß" - Jan Ole Suhr, 1993.
  1172.  
  1173.                   Bye, bye and don't forget to register ;-)
  1174.  
  1175.                                  Jan Ole Suhr
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.          P.S.: Many  thanks to Thomas Meyer for translating the whole
  1184.                document into English *AND* formatting it with PROFF! 
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.    Translation: T. Meyer            Page 19                    July 4th, 1992
  1217.  
  1218.